06. Markdown 单元格

Markdown 单元格

如前所述,单元格也可用于以 Markdown 编写的文本。Markdown 是格式化语法,可让你加入链接、将文本样式设为粗体或斜体和设置代码格式。像代码单元格一样,按 Shift + EnterCtrl + Enter 可运行 Markdown 单元格,这会将 Markdown 呈现为格式化文本。加入文本可让你直接在代码旁写出叙述性文档,以及为代码和思路编写文档。

你可以在此处查找文档,但我会提供简短的入门文档。

标题

要编写标题,可在文本前放置井号,即 #(英文读作 pound、hash 或 octothorpe)。一个 # 呈现为 h1 标题,两个 # 是 h2 标题,依此类推。类似以下所示:

# Header 1
## Header 2
### Header 3

呈现为

Header 1

Header 2

Header 3

链接

要在 Markdown 中添加链接,请在文本两侧加上方括号,并在 URL 两侧加上圆括号,例如:[Udacity's home page](https://www.udacity.com) 表示指向 Udacity's home page 的链接。

强调效果

可以使用星号或下划线(*_)来表示粗体或斜体,从而添加强调效果。对于斜体,在文本两侧加上一个星号或下划线,例如 _gelato_*gelato* 会呈现为 gelato

粗体文本使用两个符号,例如 **aardvark**__aardvark__ 会呈现为 aardvark

只要在文本两侧使用相同的符号,星号和下划线的作用都一样。

代码

可以通过两种不同的方式显示代码,一种是与文本内联,另一种是将代码块与文本分离。要将代码变为内联格式,请在文本两侧加上反撇号。例如,`string.punctuation` 会呈现为 string.punctuation

要创建代码块,请另起一行并用三个反撇号(一般在键盘数字 1 左边)将文本包起来:

```
import requests
response = requests.get('https://www.udacity.com')
```

或者将代码块的每一行都缩进四个空格。

import requests
response = requests.get('https://www.udacity.com')

数学表达式

在 Markdown 单元格中,可以使用 LaTeX 符号创建数学表达式。notebook 使用 MathJax 将 LaTeX 符号呈现为数学符号。要启动数学模式,请在 LaTeX 符号两侧加上美元符号(例如 $y = mx + b$),以创建内联的数学表达式。对于数学符号块,请使用两个美元符号:

$$
y = \frac{a}{b+c}
$$

此功能的确很有用,因此,如果你没有用过 LaTeX,请阅读这篇入门文档,它介绍了如何使用 LaTeX 来创建数学表达式。

小结

在编写 Markdown 时,可以参考这个速查指南。我建议使用 Markdown 单元格,与使用一堆代码块相比,这使 notebook 变得更易于阅读。